<!DOCTYPE HTML><html lang="en">
<HEAD>

<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >

<meta charset="utf-8">
<TITLE>Controls</TITLE>

<link rel="stylesheet" type="text/css" HREF="../book.css">
<style>
	table, th, td {
	  border: 1px solid black;
	  border-collapse: collapse;
	}
</style>
</HEAD>
<BODY>

<H3>Controls</H3>

<p>A <a href="../reference/api/org/eclipse/swt/widgets/Control.html"><strong>Control</strong></a>
is a widget that you can create and place anywhere you want in your widget
parent/child tree.  The <a href="../reference/api/org/eclipse/swt/package-summary.html">SWT
API reference</a> and examples contains detailed information about the
different kinds of controls and their usage.  The
<strong><a href="../reference/api/org/eclipse/swt/widgets/package-summary.html">org.eclipse.swt.widgets</a></strong>
package defines the core set of widgets in SWT.  The following table summarizes
the concrete types of controls provided in this package.</p>
 

<table style="width:60%">
<colgroup>
    <col style="width:25%">
    <col style="width:75%">
</colgroup>
<tr>
<th><div CLASS="CellHeading">Widget</div></th>
<th><div CLASS="CellHeading">Purpose</div></th>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/browser/Browser.html">Browser</a></strong></td>
<td>Control containing a native HTML renderer.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Button.html">Button</a></strong></td>
<td>Selectable control that issues notification when pressed and/or
released.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Canvas.html">Canvas</a></strong></td>
<td>Composite control that provides a surface for drawing arbitrary graphics.
Often used to implement custom controls.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Caret.html">Caret</a></strong></td>
<td>An i-beam that is typically used as the insertion point for text.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Combo.html">Combo</a></strong></td>
<td>Selectable control that allows the user to choose a string from a list of
strings, or optionally type a new value into an editable text field.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Composite.html">Composite</a></strong></td>
<td>Control that is capable of containing other widgets.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolBar.html">CoolBar</a></strong></td>
<td>Composite control that allows users to dynamically reposition the cool items
contained in the bar.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolItem.html">CoolItem</a></strong></td>
<td>Selectable user interface object that represents a dynamically positionable
area of a cool bar.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/DateTime.html">DateTime</a></strong></td>
<td>Selectable user interface object that allows the user to enter and modify date or time values.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ExpandBar.html">ExpandBar</a></strong></td>
<td>Composite control that groups pages that can be shown or hidden by the user with labeled headers.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ExpandItem.html">ExpandItem</a></strong></td>
<td>Selectable user interface object corresponding to a header for a page in an ExpandBar.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Group.html">Group</a></strong></td>
<td>Composite control that groups other widgets and surrounds them with an
etched border and/or label.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Label.html">Label</a></strong></td>
<td>Non-selectable control that displays a string or an image.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Link.html">Link</a></strong></td>
<td>Selectable control that displays a text with links.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/List.html">List</a></strong></td>
<td>Selectable control that allows the user to choose a string or strings from a
list of strings.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Menu.html">Menu</a></strong></td>
<td>User interface object that contains menu items.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/MenuItem.html">MenuItem</a></strong></td>
<td>Selectable user interface object that represents an item in a menu.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ProgressBar.html">ProgressBar</a></strong></td>
<td>Non-selectable control that displays progress to the user, typically in the
form of a bar graph.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Sash.html">Sash</a></strong></td>
<td>Selectable control that allows the user to drag a rubber banded outline of
the sash within the parent window.  Used to allow users to resize child widgets
by repositioning their dividing line.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Scale.html">Scale</a></strong></td>
<td>Selectable control that represents a range of numeric values.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ScrollBar.html">ScrollBar</a></strong></td>
<td>Selectable control that represents a range of positive numeric values. Used
in a Composite that has V_SCROLL and/or H_SCROLL styles.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Shell.html">Shell</a></strong></td>
<td>Window that is managed by the OS window manager. Shells can be parented by
a Display (top level shells) or by another shell (secondary shells).</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Slider.html">Slider</a></strong></td>
<td>Selectable control that represents a range of numeric values.  A slider is
distinguished from a scale by providing a draggable thumb that can adjust the
current value along the range.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Spinner.html">Spinner</a></strong></td>
<td>Selectable control that allows the user to enter and modify numeric
values.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabFolder.html">TabFolder</a></strong></td>
<td>Composite control that groups pages that can be selected by the user using
labeled tabs.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabItem.html">TabItem</a></strong></td>
<td>Selectable user interface object corresponding to a tab for a page in a tab
folder.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Table.html">Table</a></strong></td>
<td>Selectable control that displays a list of table items that can be selected
by the user.  Items are presented in rows that display multiple columns
representing different aspects of the items.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableColumn.html">TableColumn</a></strong></td>
<td>Selectable user interface object that represents a column in a table.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableItem.html">TableItem</a></strong></td>
<td>Selectable user interface object that represents an item in a table.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Text.html">Text</a></strong></td>
<td>Editable control that allows the user to type text into it.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolBar.html">ToolBar</a></strong></td>
<td>Composite control that supports the layout of selectable tool bar
items.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolItem.html">ToolItem</a></strong></td>
<td>Selectable user interface object that represents an item in a tool bar.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tree.html">Tree</a></strong></td>
<td>Selectable control that displays a hierarchical list of tree items that can
be selected by the user.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeColumn.html">TreeColumn</a></strong></td>
<td>Selectable user interface object that represents a column in a tree.</td>
</tr>

<tr>
<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeItem.html">TreeItem</a></strong></td>
<td>Selectable user interface object that represents a hierarchy of tree items
in a tree.</td>
</tr>
</table>

</BODY>
</HTML>